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INTRODUCTION 


The Modular System Control Development Model (MSCDM) consists of 
nine functional nodes: Station-to-Station Communications Inter- 
face (SSCI), Voice Service Quality Control (VSQC), Digital Service 
Quality Control (DSQC), Data Base Management Service (DBMS), 
Operator Control and Report Interface (OCRI), Baseband Signal 
Analysis and Wide Band Signal Analysis (BWBSA), Fault Isolation 
and Control Coordination (FIAC), Switch Data Collection and 
Analysis (SDCA), and Simulated Input Generator (SIG). Each of 
these nodes is implemented using microcomputer hardware and soft- 
ware, and node intercommunication is performed via a Burroughs 
loop architecture under control of a distributed master control 


program (DMCP). 


Each node can communicate with any other node on the _ loop; 
however, the nodal software for the MSCDM application defines the 
flow of information in the system. For example, the OCRI terminal 
normally communicates with the DBMS node, which runs the User 
Language. The other ESM terminals communicate with the User 


Language via the loop 4-5 gateway Node 21 (SSCI). 


A simulated input generator (SIG) generates inputs to the VSQC, 
DSQC and BWBSA, which communicate faults to the FIAC module. FIAC 
generates event reports to the OCRI and DBMS. The PDP 11/40 in 
loop 2 generates inputs to the SDCA which generates fault reports 


to the OCRI and DBMS. The DBMS, OCRI and FIAC communicate with 


the other loops via SSCI. 


eee 
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An LA36 DECWRITER is be used as the OCRI hard-copy terminal 
attached to node 25. A VT52 DECScope is be used as a local CRT 


terminal connected to the Program Development Unit (PDU). 


The Digital Equipment Corporation System's software for the PDP- 
11/V03 is contained on 9 - Floppy diskettes conforming to DEC's 


RXO1 Floppy drive format. 


The MSCDM applications software which runs on the PDP-11/V03 and 


the LSI-11/2 nodes is contained on 2]1- floppy diskettes. 


References for the FORTRAN and MACRO-11 languages and the PDP-1ll 


/V03 system used include documentation: 


l. "RT-1ll System Generation Manual" 
2. “Ineroduction to RT" 

3. “RT-11l System User's Guide” 

4. "RT-11 System Message Manual" 

5. “PDP~11 MACRO Language Manual" 
6. "PDP~1l FORTRAN Language Manual" 
7. “Advanced Programmer's Guide" 


— — 


1.0 MSCDM DMCP and APPLICATION Programs 


The MSCDM loop contains nine LSI-1ll microprocessors, eight of 
which are configured with loop interface units. The ninth is a 
LSI-l1l which contains three asynchronous interfaces, and is used 
as the simulated input generator to VSQC, DSQC and BWBSA. The 
eight loop nodes run a program called the Distributed Master 
Control Program (DMCP), which performs loop- and exodevice 
interfacing and the queuing of incoming and outgoing messages. 
Each MSCDM loop microprocessor also runs an application program 
which is then linked to the DMCP to form a load module for each 
node. Section 1.1 provides a functional description of the DMCP 


and the common routines of DMCP shared by the eight loop nodes. 


Sections 1.2 to 1.9 contain the description of non-common routines 
along with the listings of the DMCP and application programs for 
each node (e.g., Section 1.2 Node 21 (SSCI), Section 1.3 Node 22 
(VSQC), Gtci). Section 1.10 is the description and listings of 
the MSCDM User Language which is the application program for Node 
24 (DBMS). Section l.ll is the description and listings of the 
two simulated input programs used by MSCDM. At the end of each 


Section (1.2 - 1.11) there are listings of the command files used 


for compiling and linking the DMCP and application source files. 
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1.1 THE DISTRIBUTED MASTER CONTROL PROGRAM 


The Distributed Master Control Program (DMCP) resides mainly in 
the microprocessor (LSI-11) nodes which make up the Burroughs Loop 
Architecture. DMCP modules which reside in the host computer 
include a Down-Line Load Module which loads remote microprocessors 
with memory image object files, an Initialization Module which is 
used at start-up time, and a System Control Resource Allocation 
Module which is used for dynamic system reconfiguration. In 
addition, the host computer stores the tables required by the 
node microprocessors for reconfiguration and functional task 


assignment. 


1.1.1 DMCP Functional Description 


The DMCP can be described in terms of the following functional 
modules: Interrrupt Handlers, Protocol Modules, Loop Manager, 
Read and Write Modules, Queue Manager, Command Interpreter, Error 
Module, and I/O Queues. These functional modules are described 


below. 


The DMCP is an Interrupt or Event Driven System. Events result in 
interrupts being generated by the external hardware (e.g., Loop 
Interface Unit - LIU) to the LSI-1l1 microprocessor. The interrupt 
results in the execution of a vectored interrupt address which 


passes program control to an I/O Handler (written in MACRO-11 


Assembly Language). 


A general understanding of the DMCP can be obtained by examining 


the flow of control resulting from an event. Figure 3 gives the 
flow control resulting from a packet being received by an LIU from 
the loop. The LIU generates an interrupt to its microprocessor 
which results in the execution of the LIU Handler. The LIU 
Handler examines a l6-bit LIU Status Register. Conditions which 
the LIU Status Register indicate include Buffer 0 or 1 Full, CRC 0 
or 1 OK, Input Buffer 0 or 1 Overflow, Line Switch Primary, and 
Line Switch Backup. Depending on the LIU Status Register value 
and the information received, control can be passed to one of 
three modules: Error Module, Input Q Handler or Command 
Interpreter. The Error Module is entered if the LIU status 
register indicates an error condition (e.y., Line Switch Primary). 
An error report is generated describing the failure. The Loop 
Protocol Module is then entered and the Packet Header Information 
will be determined (e.g., sequence number destination and source 
process ID's). The Loop Address field is also determined for the 
process ID of the destination task which accepts reports. Finally 


the packet is written to the loop using the Write to Loop Module. 


The second path in Figure 3 is followed if the input from the loop 
is a normal type packet destined to an Exodevice (e.g., terminal, 
minicomputer, data comm line). The Input Q Handler is entered to 
link the packet to the Input to Exodevice Queue. The Exodevice 
Protocol Module builds the protocol characters for the Exodevice 
(e.g., SOH, ETX). The Write to Exodevice Module is then called to 


write the packet onto the Loop. 


ERROR 
MODULE 
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PROTOCOL 
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TO LOOP 
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HANDLER INTERPRETER 


EXODEVICE 
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WRITE TO 
EXODEVICE 
HANDLER 


Input from Loop Flow Control 
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The third path in Figure 3 is the command interpreter function, 


for handling ACK and NAK messages. 


The control for an input from an Exodevice is given in Figure 4. 
The interrupt results in the execution of the Exodevice Read 
Handler which can pass control to two modules. A normal loop 
destined packet results in the Output Q Handler being called. The 
Loop Protocol Module formats the header of the packet and deter- 
mines the loop address. The Write to Loop Module writes the 


packet to the loop. 


The second path in Figure 4 results in the Command Interpreter. 
This module interprets commands originating from the Exodevice. 
An example would be an ATTACH command which would be used to 
logically attach a peripheral connected to the loop to a 


iiinicomputer. 


The DMCP Idle Flow Control is given in Figure 5. The Input Q 
Handler is entered to examine the current input queue size. The 
Output Q Handler is entered to examine whether the packet in the 
output queue has been ACKed or NAKed. The Loop Manager maintains 
the watchdog timing function for write token timeouts and retrans- 
missions of packets that were not ACKed or NAKed. The System 


Monitor sends messages to its Exodevice and a System Master to 


monitor equipment operation. 
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Figure 4. Input from Exodevice Flow Control 
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DMCFP Idle Flow Control 
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1.1.1.1 Interrupt Handlers Function 


Interrupt Handlers are used to process I/O interrupts. The DMCP 
in each node contains four basic types. The LIU Handler, 
examines the LIU Status Register and does a Memory Access (DMA) 


transfer to move a packet (at least 256 bytes) from the LIU buf- 


fers to the microprocessor memory. The Clock Handler processes 
interrupts from the 60 Hz Line Frequency Clock. Interrupts occur 
every 16.67 msec.; a clock register in memory is incremented at 


each interrupt. The LIU and Clock Handlers are identical for each 


node. 


A Read and Write Exodevice is used for each type of Exodevice. 
Peripheral and data comm handlers receive interrupts on a per byte 
basis. Interrupt Handlers are written in  MACRO-1l Assembly 


Language. 
1.1.1.2 Protocol Modules Function 


There are two basic types of Protocol Modules. A Loop Protocol 
Module and Exodevice Protocol Modules. The Loop Protocol Module 
is the same at all nodes. Exodevice Protocol Modules are used for 
each type of exodevice. Protocol Modules format packets, perform 
code conversion if necessary, and handle communication protocols 
for the loop, processors, peripherals, and data comn. The Loop 
Protocol Module determines destination loop addresses based upon 
its tables for reconfiguration and functional task assignment. 
Protocol Modules are either separately written in FORTRAN IV or 


combined with Interrupt Handlers and written in MACRO-11. 
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1.1.1.3 Loop Manager Function 


The Loop Manager is written in FORTRAN and is identical for all 
nodes. If manages certain control functions associated with the 
loop. One such function is the regeneration of Write Tokens. A 
Write Token is a Special circulating control packet which the LIU 
must recognize before it can write on the loop. If a Write Token 
is not received within a certain amount of time, the Loop Manager 
creates a new Write Token. Another function is the resending of 
packets to the loop that have not ACKed or NAKed within a certain 


amount of time. 

1.1.1.4 Read Module Function 
Read Modules read data from either the loop or an Exodevice. When 

combined with an Interrupt Handler, Read Modules are written in 

MACRO-L1l Assembly Lanquage. 

1.1.1.5 Write Module Function 

Write Modules write data to the loop or an_ Exodevice. When 


combined with an Interrupt Handler, Write Modules are written in 


Assembly Language. 


1.1.1.6 Queue Manager Function 
The Queue Manager maintains input and output queues. It maintains 
status on the number in queue and the current top-of-queue 
pointer. It moves certain control type command messayes to top-of- 
queue or to other I/O buffers (e.g., intermediate ACK's). The 
Queue Manager monitors the size of queue and generates flow 
control command messayes. The flow control messages direct nodes 
to stop sending to a node whose queue is nearly fully and resume 
sending to a node whose queue has emptied. The Queue Manager is 
used at all nodes. It is written in FORTRAN and interfaces to 


Interrupt Handlers via COMMON I/O buffers. 


1.1.1.7 Command Interpreter Function 


The Command Interpreter is used to perform nodal control functions 
as a result of interpreting command packets (utilizing the header 
control bytes). Many of these command packets such as ACK-NAK's, 
line switch, etc. are described above. A function not listed 
above is Down-Line Loading Command interpretation. A Down-Line 
Loading command forces the microprocessor to execute a bootstrap 
loader program stored in PROM memory. The bootstrap loader 
program loads data coming from the loop into the RAM memory. The 
data is sent to Absolute Loader Format by the loader host computer 
(Downline Load Module). The Loader PROM program returns program 
control to the first executable RAM memory location when an end-of- 
load command is received. The LSI-11 microprocessor is strapped 
such that the bootstrap loader PROM is executed at power-up time. 


The bootstrap loader PROM program is written in Assembly Language. 


See awry 
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1.1.1.8 Error Module Function 


The Error Module is written in FORTRAN and is used at all nodes. 
The Error Module formats error reports to describe nodal error 
conditions. These error reports include error conditions 
indicated by the LIU Status Register (e.g., Loopback), no response 
from destination nodes, and queue overflow. The reports are sent 


to a loop connected peripheral. 


1.1.1.9 I/O Queues Function 


I/O Queues are maintained by the Queue Managers. The maximum 
queue sizes are determined by the speed of the Exodevice 
Interface, the traffic at the node, and the availability memory 
(64K bytes maximum). Output to the loop queues is effectively of 
size one since each packet is ACKed before the next one is sent. 
This guarantees that packets are received in the same order as 


sent and eliminates the need for packet sequencing software. 


1.1.2 DMCP ROUTINES 


The DMCP Control Software comprises a set of FORTRAN and MACRO-11] 
routines which are linked to an application program to form a load 


module which is then down-line loaded to the LSI-11 nodes. 


Since most of the code is common to all nodes, the description of 


the common routines will be divided and discussed in this section. 


Unique code or routines will be discussed later under the sections 


devoted to each node (i.e., Sections 1.2 to 1.9). 


Bivbere and 


Program Nodal Description (FORTRAN) 


is the main program of the DMCP and its functions are to 


This 


examine the queues to see if they are empty or full, move data to 


empty queues, perform output to the LIU and exodevices, and check 


for timeouts, for write token detect, and LIU output message 


me me mt 


It also calls the application program when there 


acknowledgement. 


is something in the loop input queue. 


1.1.2.2 Subroutine IGETSP (FORTRAN) 


The purpose of this subroutine is to fetch a pointer to a free 


packet array from the free packet list. The free packet list is 


the list 


examined to determine if is empty; if it is, the INIT 


subroutine is called. If not, 


a pointer to an available packet is 


fetched. 


1.1.2.3 Subroutine ENQUE (FORTRAN) 


This subroutine adds an element at the tail of a queue. If the 


current tail is not at the lower iimit of the queue, the new 


element is appended and the tail pointer adjusted. Otherwise, a 


check is made to determine whether or not the ENQUEis full. If 
the queue is not full, the queue is moved so that the head is at 


the upper limit and the new element is added. If full, subroutine 


INIT is called. 


1.1.2.4 Subroutine DEQUE (FORTRAN) 


This subroutine returns the head of a specified queue element. 
The element may or may not be removed from the queue, depending 


upon a parameter setting. 


1.1.2.5 Subroutine ACKNAK (FORTRAN) 


This subroutine is called when an ACK or NAK message is received. 
In the case of the ACK message, the output queue is marked empty, 
the pointer to the packet pointed to by the output queue is 


returned to the free packet list and the write flags are reset. 


Subroutine INPTQ (FORTRAN) 


This subroutine checks the validity of a non-control message 
received from the LIU. If the message is valid, an ACK message is 
generated and placed in the ACK queue. If the message is not 


valid, a NAK messaye is generated. 
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This procedure determines whether a message received from the LIU 


a 


ES 

1.1.2.7 Subroutine LPINPT (FORTRAN ) j 
is a control message, an ACK or NAK message, or a normal message. | 

i The appropriate subroutine is called after the determination has 

been made. For ACK's and NAK's, subroutine ACKNAK is called. For 


normal messages, subroutine INPTQ is called for normal messages. 


a a 


1.1.2.8 Subroutine LINLOS (FORTRAN ) } <4 
This subroutine assembles a message indicating the switching of 
the primary or backup lines. The message is sent to Node 25 and 


printed on the LA-36. f 


1.1.2.9 Subroutine INIT (FORTRAN) 


This subroutine initializes the queues, the free arrays, the LID 
of the node, the read address of the node, the LID/FAD table and 


the address comparison RAM of the LIU. 
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1.1.2.10 Subroutine MASTER (MACRO) 


This subroutine initializes all interrupt vectors of the devices 
of the node, lowers the CPU priority to allow interrupts to be 


processed. 
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1.1.2.11 Subroutine LIUINT (MACRO) 


This subroutine initializes the LIU's, address comparison RAM, 
bp 


both input and output buffers, and the status register. 


1.1.2.12 Subroutine LIO (MACRO) 


This subroutine in entered by a interrupt from the LIU. It reads 
the status of the LIU and determines what caused the interrupt. 
If one of the input buffers is full, it unloads them and calls 
subroutine LPINPT. It it was a line loss, it calls subroutine 
LINLOS, and if it was a bad CRC on either of the input buffers, it 


unloads the butfers and calls subroutine LPINPT. 


1.1.2.13 Subroutine ENABLE (MACRO) 


This subroutine is passed a variable which either lowers the CPU 


priority to enable interrpts or raises priority thus disabling 


interrupts from being acknowleged. 


1.1.2.14 Subroutine Switch (MACRO) 


This subroutine is passed a variable which either sets or resets 


the backup or primary line switches. 
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1.1.2.15 Subroutine Status (MACRO) 


This subroutine is passed one argument that specifies which LIU 


status byte is to be read. That status byte is then passed back as 


the second argument in the call statement. 


1.1.2.16 Subroutine WTOKEN (MACRO) 


This subroutine is called to regenerate a write token in the loop. 


1.1.2.17 Subroutine TIME (MACRO) 


The subroutine is the interrupt routine that is called by the LTC 


interrupt. It increments a variable and checks for counter over- 


flow. 


1.1.2.18 Subroutine RAM (MACRO) 


The subroutine is called to read or write a location in the LIU 


address comparison RAM. 


1.1.2.19 Subroutine LPOUT (MACRO) 


This subroutine is called to load output buffer 0 with a message, 


and load output buffer 1 with a write token. 
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1.1.2.20 Subroutine RDPNT (MACRO) 


This subroutine is called to read a buffer pointer of either input 


buffer 0 or 1 or output buffer 0 or 1. 


1.1.2.21 Subroutine RSTART (MACRO) 


The subroutine is called to either restart nodal software, halt 


processor or jump to loader prom. 
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1. NODE 21 (SSCI) 


The Station-to-Station Communication Interface (SSCI) serves as a 
gateway node interface to loop 4 of the ESM. The loop 4 - loop 5 
interface implemented is 9600 baud asynchronous. The SSCI is used 
to simulate communication between different system control sites. 
The SSCI performs code conversion, intransit queueing and packet 


routing. 


1.2.1 Program Description 


kote bed Refer to Section 1.1 for descriptions of routines - 
IGETSP, ENQUE, DEQUE, INIT, LINLOS, MASTER, LIUINT, LIO, ENABLE, 


SWITCH, STATUS, WTOKEN, TIME, RAM, LPOUT, RDPNT, RSTART. 


1.2.1.2 Program NODAL Description (FORTRAN) 


This 1s the main program for the SSCI DMCP and its functions are 
to examine the queues to see if they are empty or full, move data 
to empty queues, write the output of all the incoming loop 
messages to the gateway interface (Node 13, loop 4) and place on 
loop 5 all messages received from the gateway interface, SSCI does 
not acknowledge messages received from the loop, ESM employs "end 


to end" acknowledgement (SSCI functions only as the gateway). 


1.2.1.3 Subroutine INPTQ (FORTRAN) 


This subroutine does the queueing of incoming packet from the way. 


No check is made for control packets. 


Subroutine UPINPT (FORTRAN) 


This subroutine only calls INPTQ routine because SSCI does 


scan any of the incoming messages from the loop interface. 


incoming messages go to the gateway interface, also LPINPT do 


generate ACK or NAK fo messages. 


1.2.1.5 Subroutine GIO (MACRO) 


This subroutine is the interrupt handler for the gate-way inter- 


face. It reads the message from the interface and then sets a 


lag containing the byte count of that message. 


1.2.1.6 Subroutine GOUT (MACRO) 


This subroutine is called to send a message over the gateway 


interface to node 13, loop 4. It's passed one argument the byte 


count of the message to be sent. 
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1.3 NODE 22 (VSQC) 


The Voice Service Quality Control (VSoc) module assesses the 
performance of voice channels for the purpose of detecting 
degrading performance and assisting in fault isolation. The MSCDM 
is capable of monitoring at least 1000 channels. By convention, 
channels numbered 1-500 are monitored by the VSQC. There are six 


parameters to be checked per channel. 


l. Peak Power (PK) 

2. Average Power (AV) 

3. Frequency Offset (FO) 
4. Phase Jitter (PJ) 

5. C-Message Noise (CN) 


6. 3 KHz Flat Noise (FN) 


Values for these parameters are generated by the Simulated Inout 
Generator (SIG) microcomputer. Thresholding is done on the 
Parameters by comparison with the Red High (RH), Red Low (RL), 
Amber High (AH), and Amber Low (AL) values in order to determine 
whether the channel parameters are in the Red, Amber or Green 


region. 
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VSQC Parameter Thresholds 


Parameter RH RL AH AL 

; PK 10 0 9 2 
AV 10 0 8 2 

FO 20 ~100 0 -80 | 

PJ 10 ~90 -10 ~70 

CN 0 ~80 -10 -60 | 


FN 20 -100 0 -80 | 
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The VSQC also performs trending on the parameter values. Trending 
begins when the parameter is within a delta value of the 
Threshold. The critical trending values for the VSQC parameter 


thresholds are given below. 


vVSQC Critical Trending Values 


Parameter = Delta «= RHT. = RL ART ALT 
PK 0.5 9.5 0.5 ToS 2.5 
AV 0.5 9.5 0.5 Thess: 225 
FO 3 17 -97 =3 -77 
PJ 2 8 -88 -8 -68 
CN 1 -1 -79 -19 -59 
FN 2 18 -98 =2 -78 


The threshold and trending values may be modified by modifying the 


program DATA statement and recompiling the VSQC nodal software. 


Event Reports are sent to the FIAC when a parameter value is Amber 
or Red and the Event Reporting condition parameter is turned ON 
(via Module Update Mode 3 of the User Language); The Event Report 
consists of an 8-byte trunk name, 4-byte channel number, one-byte 
condition, one-byte parameter number that caused the Red or Amber 


condition, 3-byte monitor point number, and the node designator to 


which reports should be sent. 


Rei iain adc cube tin Lua ain ak ia ene ee Sine bundle asdaany oa... 


The VSQC interprets command fron the DBMS generated by Mode 3 of 


the User Language. The commands include Event Reporting ON or 
OFF; if ON, the node designator to which the Event. Reports are to 
be sent, i.e., the terminal used for display, is given. The VSQC 
also interprets the command, received as a packet from the loop, 
to measure a specific channel which is sent to the SIG; che 
resulting measurement value is sent to the OCRI terminal request- 


ing the measurement (via Mode 3 of the User Language). 


1.3.1 Program Descriptions 


1.3.1.1 Refer to Section 1.1 for descriptions of routines NODAL, 
IGETSP, ENQUE, DEQUE, ACKNAK, INPTQ, LPINPT, INIT, LINLOS, MASTER, 
LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME RAM, LPOUT, 


RDPNT, RSTART. 


1.3.1.2 Subroutine VSQC (FORTRAN) 


This subroutine is called from the nodal program when a packet has 
been received from the SIG interface. It decodes the simulated 
input values read from the SIG and performs the function described 


in Section 1.3. 


1.3.1.3 Subroutine TREND (FORTRAN) 


This subroutine is called by the VSQC routine to perform the 
trending on the values sent by the SIG. This value is compared 
with DELTA values; when a channel consistently is in the DELTA 


region, an event report is generated. 


1.3.1.4 Subroutine VSQLP (FORTRAN) 


The subroutine is called from program NODAL when a packet is 
received from the loop. It performs one of three functions: turns 
reporting on or off, and takes a measurement of a _ specified 


channel. 


1.3.1.5 Subroutine SIO (MACRO) 


The subroutine is called from an interrupt received by the SIG 


interface; it then reads the message and sets a flag containing 


the byte count of the message. 


1.3.1.6 Subroutine SOUT (MACRO) 


This subroutine is called from subroutine VSQC and passes to the 


SIG processor the channel number of a channel for which the user 


language requests a measurement. 


1.3.1.7 Subroutine READY (MACRO) 


This subroutine is called to signal the SIG that VSQC is ready for 


another measurement. 
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1.4 NODE 23 (DSQC) 


The Digital Service Quality Control (DSQC) module assesses the 
performance of digital data channels for the purpose of detecting 
degrading performance of these channels with respect to increasing 
error rates, and to assist in fault isolation. Channels numbered 
501-1000 are arbitrarily monitored by the DSQC. There are three 


parameters to be checked per channel: 


1. Pseudo Error Rate (PE) 


2. Bit Error Rate (BIE) 


3. Block Error Rate (BLE) 


DSQC Parameters Thresholds 


Parameter 


The parameter values are simulated by the Simulated = Input 


Generator (SIG). 


Trending occurs when the DWQC module detects a parameter value 


within a delta value equal to one of the Red threshold or a delta 
value equal to two of the Amber threshold. Event reports are sent 
to FIAC using the same format as described for VSQC. The DSQC 


interprets the same commands generated by the DBMS as the VSQC. 


1.4.1 Program Descriptions 


1.4.1.1 Refer to Section 1.1 for descriptions of routines NODAL, 


DEQUE, ACKNAK, INPTQ, LPINPT, LINLOS, MASTER, 


INIT, 


IGETSP, ENQUE, 


LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME RAM, LPOUT, 


RDPNT, RSTART. 


1.4.1.2 Subroutine DSOC (FORTRAN) 


This subroutine is called from the nodal program when a packet has 


been received from the SIG interface. It decodes the simulated 


input values read from the SIG and performs the function described 


in Section 1.4. 


1.4.1.3 Subroutine TREND (FORTRAN) 


This subroutine is called by the DSQC routine to perform the 


trending on the values sent by the SIG. This value is compared 


with DELTA values; when a channel consistently is in the DELTA 


region, an event report is generated. 


1.4.1.4 Subroutine DSQCLP (FORTRAN) 


The subroutine is called from program NODAL when a packet is 


received from the loop. It performs one of three functions: turns 


reporting on or off, and takes a measurement of a_ specified 


channel. 


1.4.1.5 Subroutine SIO (MACRO) 


The subroutine is called from an interrupt received by the SIG 


interface; it then reads the message and sets a flag containing 


the byte count of the message. 


1.4.1.6 Subroutine SOUT (MACRO) 


This subroutine is called from subroutine DSQC and passes to the 


SIG processor the channel number of a channel tor which the user 


language requests a measurement. 


1.4.1.7 Subroutine READY (MACRO) 


This subroutine is called to signal the SIG that DSQC is ready for 


another measurement. 
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1.5 NODE 24 DMCP (DBMS) 


The Data Base Management Service (DBMS) performs the data base 
maintenance functions. It maintains the display files for the 
human interface User Language, system configuration files, equip- 
ment status files, and object files ‘for the various modules. The 
User Language runs on the DBMS and is used to control the system. 
Mini disks are used to store the various files. The DBMS may also 
be used as a Program Development Unit (PDU) with a local CRT 
terminal when not being used for the MSCDM application. The PDU 
develops and maintains software for the MSCDM. The PDU runs the 
RT-1ll Operating System and it may be used as a general purpose 


processor. 

1.5.1 Program Descriptions 

1.5.1.1 Refer to Section 1.1 for descriptions of routines - 
NODAL, IGETSP, ENQUE, DEQUE, ACKNAK, INPTQ, LPINPT, INIT, LINLOS, 
MASTER, LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME, RAM, 
LPOUT, RDPNT, RSTART. 


1.5.1.2 Subroutine USRLANG 


MSCDM user language is the applications program for node 24, refer 


to Section 1.10 tor description and listings. 
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1.6 NODE 25 (OCRI) 


Control and Report Interface (OCRI) performs the 


The Operator 


functions of interfacing to the site operator. The User Language 


interface, when the OCRI terminal is ATTACHED to the DMBS node, 


allows the operator to control the site, request status informa- 


tion concerning site and equipment performance and prepare site 


reports which are forwarded to other sites such as the ACOC. 


Operator-to-operator messages are also supported by the user | aa 


The OCRI terminal. 


Language. can be used to print event reports, 


fault reports, and alarms for the simulated equipment generated by 


the FIAC and SDCA modules, and error messages concerning the FDM 


itself generated by the nodal modules (e.g., Loop-Back in effect, 


queue overflow). 


1.6.1 Program Descriptions 


1.6.1.1 Refer to Section 1.1 for descriptions of routines- 


LPINPT, INIT, LINLOS, 


NODAL, ACKNAK, INPTQ, 


ENQUE, DEQUE, 


IGETSP, 


LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME, RAM, 


MASTER, 


LPOUT, RDPNT, RSTART. 


1.6.1.2 Subroutine HINPUT (FORTRAN) 


This subroutine is called by the interrupt handler of the LA-36. 


This routine is where the ATTACH command is checked and decoded. 


If the message is not a command it is queued. 
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ii 


1.6.1.3 Subroutine CIO (MACRO) 


Ftc ve TROT 


This subroutine is the interrupt handler for the LA-36 terminal. 


t 165 


ee" 


It reads the ASCII data as it's typed, checks for deletes, control, 
7 
| and xon-xoff characters and stores them until a RETURN is typed. 


When RETURN is detected subroutine HINPUT is called. 


1.6.1.4 Subroutine COUT (MACRO) 


ET mee 


This subroutine is used to print a message received from the loop | 
on the LA-36. It's passed one argument the byte count to be ‘ 


printed. 
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1.7 NODE 26 (BWBSA) 


The Base Band Signal Analysis and Wide Banc Signal Analysis 
(BWBSA) module assesses the performance of link equipment. Three 
links are monitored. There are seven parameters to be checked per 


link for the baseband, and six for the wideband: 


1. Transmitter Percent Modulation (BTPM) 
2. Transmitter Frequency Deviation (BTFD) 
3. Relative Transmitter Power (BRTP) 

4. Receiver AGC Voltage (BRAV) 

5. Receiver IF Output (BRIO) 

6. Multiplex Baseband Levels (BMBL) 

7. Multiplex Pilot Levels (BMPL) 

8. Transmitter Percent Deviation (WTFD) 
9. Transmitter Frequency Deviation (WTFD) 
10. Relative Transmitter Power (WRTP) 

ll. Receiver AGC Voltage (WRAV) 

12. Receiver IF Output (WRIO) 


13. Multiplexor Pseudo Error Rate (WMPE) 


The SIG produces simulated values for three parameters. In 
addition, alarms are generated associated with the three links for 
transmitters, receivers, and multiplexers. Alarms and Red and 
Amber threshold values are sent to the FIAC as Event Reports. 
Event Reports consist of one-byte link number, 2-byte baseband 
number, 2-byte wideband number, one-byte supergroup, one-byte 


group, one-byte condition, a 3-byte monitor point number, and the 


node designator to which reports should be sent. 
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The BWBSA interprets commands from the DBMS similar to the VSQC 
and DSQC except that measurements are performed for 3 links rather 


than channels. 


1.7.1 Program Descriptions 


1.7.1.1 Refer to Section 1.1 for description of routines NODAL, 
IGETSP, ENQUE, DEQUE, ACKNAK, INPTQ, LPINPT, INIT, LINLOS, MASTER, 
LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME, RAM, LPOUT, 


RDPNT, RSTART. 


1.7.1.2 Subroutine BWBSA (FORTRAN ). 


This subroutine is called from the nodal program when a message 


has been received from the SIG. The inputs are compared with the 


thresholds and subroutine SNDRPT is called if a measurement is out 


side the threshold. 


1.7.1.3 Subroutine SNDRPT (FORTRAN ) 


This subroutine is called by routine BWBSA to send the FIAC node a 


message identifying the equipment that failed and the value of 


measurement. 


= ne ere 
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1.7.1.4 Subroutine BWSALP (FORTRAN) 


This subroutine is called by nodal when a message is received from 


the loop. It performs three functions: reporting on or off, and 


take a measurement of a Link. 


1.7.1.5 Subroutine SIO (MACRO) 


This subroutine reads the simulated inputs from the SIG. It is 


called by an interrupt and when the message is read, it sets a 


flag containing the byte count. 


1.7.1.6 Subroutine SOUT (MACRO) 


This subroutine is used to send the SIG a link number for a 


requested measurement. 


1.7.1.7 Subroutine READY (MACRO) : 


This subroutine is used to signal the SIG that the BWBSA module is 


ready for another measurement. 
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1.8 NODE 27 (FIAC) 


The Fault Isolation and Control Coordination (FIAC) module inter- 
prets Event Reports and Alarms from the VSQC, DSQC, and BWBSA 
modules for the purpose of isolating the equipment causing the 
detection of a fault condition. Amber and Red Event Reports are 
received by the FIAC and retransmitted to the destination Node 
Designator for OCRI reporting and to the DBMS in order to update 
the Equipment Status File. The OCRI operator can display and 
modify the Equipment Status File via Mode 6 of the User Language. 
Red Event Reports are reported only once when the equipment first 
fails although subsequent measurements will also result in the Red 


Region. 


The FIAC analyzes the Red Event Reports for fault indications and 
initiates isolation procedures to resolve to the equipment level 
the location of the fault. The FIAC checks the connectivity 
through the network. For the FDM, the assumed connectivity 


between the VSQC, DSQC and BWBSDA is: 


FDM Assumed Connectivity 


Connectivity Group Monitor Points 
Area l 1-333 
Area 2 334-666 


Area 3 667-1000 


aa 


239 


The FIAC collects Red Event Reports and assigns them to the 
various connectivity groups. When a connectivity group has a Red 
Event Report from VSQC, DSQC and BWBSA, the monitor points are 
compared to determine the equipment causing the fault. The lowest 
monitor point indicates the equipment causing the fault. Fault 
Reports are then sent to both the local OCRI terminal and a remote 
site OCRI. The Fault Report contains the monitor points, link and 
channel numbers for the connectivity group. The FIAC software 
contains variables used to specify the Node Designators for the 
Local and Remote destinations for Fault Reports. The default 
nodes are the OCRI terminal for Local Fault Reports and the CRT 


terminal in loop 4 for Remote Fault Reports. 


In the MSCDM, software resides on the SDCA node to simulate the 
behavior of a remote FIAC. Area 1 is used to represent the area 
associated with the MSCDM FIAC. Area 2 is used to represent the 
area associated with the remote FIAC (as simulated by SDCA). Area 
3 is used to simulate other areas for which faults cannot be 
isolated by the FIAC. The SDCA sends occasional random Event 
Reports to FIAC with Monitor Points in Area 1. FIAC sends Event 
Reports to SDCA for those Event Reports received from VSQC, DSQC, 
and BWBSA with Monitor Points in Area 2. When Red Event Reports 
are collected for the VSQC, DSQC, and BWBSA, faults can be 
isolated and reported in Areas 1 and 2 but cannot be isolated for 
Area 3. The faults that cannot be isolated are reported to local 


and remote OCRI's via a Fault Report. 
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1.8.1 Program Descriptions 
1.8.1.1 Refer to Section 1.1 for descriptions of NODAL, IGETSP, 
ENQUE, DEQUE, ACKNAK, INPTQ, LPINPT, INIT, LINLOS, MASTER, LIUINT, 


LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME, RAM, LPOUT, RDPNT, 


RSTART. 


1.8.1.2 Subroutine FIAC (FORTRAN) 


This subroutine is called when a message is received from the loop 


and perform the functions described in Section 1.8. 


1.8.1.3 Subroutine SNDRPT (FORTRAN) 


The subroutine is called by FIAC routine to send event reports to 


DBMS. 


1.8.1.4 Subroutine FAULT (FORTRAN) 


This subroutine performs the fault isolation described in Section 


1.8. 
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{ 1.9 NODE 28 (SDCA) 

| The Switch Data Collection and Analysis (SDCA) module receives 
switch traffic data generated by AUTODIN or AUTOVON switches, and 
performs loading assessments on this data to detect switch equip- 
ment saturation conditions. Traffic flow control computations and 
actions are performed. Simulated data to represent two switches 
is generated by the PDP 11/40 in loop 2. A switch condition 
report is sent by the PDP 11/40 to the SDCA approximately every 


2.5 seconds. 4 


SDCA Switch Condition Report a 

Critical Values . 

Field Description AUTODIN AUTOVON 
1 Switch # 1 2 
2 # of Transactions Siz 256 
3 # of Blocked Transactions 25 10 
4 Transaction Queue Depth 25 10 
5 # of Prescripted Transactions 10 25 
6 Trunk Group Occupancy 50 40 
7 Trunk Group Overflow 56 40 
8 Message Delay (sec. ): 10 5 
9 Maximum Message Age (sec. ), 10 5 
10 Number of Overflow Messages 10 10 
ll # of Senders 128 64 

12 # of Markers 128 64 | 

13 # of Receivers 128 64 : 

14 # of Pooled Crypto Units 128 64 } 
15 Service Time for Dial Tone (sec. ) 10 5 
16 Service Time for Crypto Unit (sec. ) 10 5 


Whenever a critical value of the table above is exceeded and the 


Event Reporting Condition Parameter is ON, the switch is 


considered to be in a saturated condition and Red Event Reports i 
are sent to the DBMS Status File and the destination Node | 


Designator for OCRI reporting. 


l 


The SDCA interprets commands from the DBMS similar to the VSQC, 


DSQC and BWBSA except that measurements are performed for 2 


switches rather than channels or links. 
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1.9.1 Program Descriptions 


1.9.1.1 Refer to Section 1.1 for descriptions of routines NODAL, 
IGETSP, ENQUE, DEQUE, ACKNAK, INPTQ, LPINPT, INIT, LINLOS, MASTER, 


LIUINT, LIO, ENABLE, SWITCH, STATUS, WTOKEN, TIME RAM, LPOUT, 
RDPNT, RSTART. 

1.9.1.2 Subroutine SDCA (FORTRAN ) 

This subroutine is called when a measurement is received for the 
11/40. The simulated inputs are decoded and the’ function 
described in Section 1.9 is performed. 

1.9.1.3 Subroutine SDCALP (FORTRAN ) 

This subrout’'ne is called when a message is received from the 
loop. Functions performed are reporting on or off, and request a 
measurement. 

1.9.1.4 Subroutine IMAGE (FORTRAN ) 

This subroutine converts a decimal number into ASCII format. 

1.9.1.5 Subroutine SIO (MACRO) 

This subroutine is the interrupt handler for the 11/40 interface. 


It reads the message of input from the 11/40 and set a flag 


containing the byte count. 
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1.10 User Language 


The User Language provides the human interface to the MSCDM and 
controls its operation. It is implemented as a dialogue between a 
processor and a terminal with displays stored as disk files. It 
is written to handle four ESM-MSCDM terminals. The User Language 
runs as the application program for node 24 (DBMS) and handles all 


disk-reads and writes. 


1.10.1 Mode 1 CRT-to-CRT 


This module allows messages to be sent from the MSCDM terminal to 
the three ESM terminals. In addition to Mode 1, an ATTACH comnand 
is provided so that a terminal can connect to another processor or 
to another terminal. When a terininal is attached to another 
terminal it can send messages directly without host processor 


intervention. 


1.10.2 Mode 2 System Inquiry 


System inquiry allows the MSCDM user to view displays that define 
the ESM Multiloop Network Simulation Facility. The default dis- 
play values which correspond to the parameters generated in the 
nodal software are stored on the mini-disk. Updates to these 
Parameters are stored on the PDP 11/40 HSTB in Loop 2. Updates 
are created via Mode 3 (System Update) of the User Language res- 
ident on HSTB. Node designators 20-28 are used for loop 5. The 


LID/FAD Conversion Tables are set up such that the FAD is given 


for the LID for that location on the display. 
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1.10.3 Mode 3 - Module Update 


This mode of operation is used to modify parameters in the other 
MSCDM nodes. The user is given a list of parameters that may be \ 
changed. The parameter changes are performed in the remote nodes 4 


by special control packets that are generated by DBMS. 
1.10.4 Mode 4 - File Access 


This mode of operation allows records of files to be accessed, 
modified, added and deleted. The files are the circuit and trunk fe 


files. 
1.10.5 Mode 5 - Report 


This mode of operation is used to generate the system control 
reports. The operator is led through a menu-selection dialogue. 
This dialogue first asks whether a file is already open so that I" 
the operator can exit from mode 5 and return to complete the 
report later. Two types of reports can be generated: channel- 
link and switch. The user is prompted for the various elements of 
the report and the format of the response. A list of remarks can 4 
be added to the report. Simulation of a report being sent to a 


different System Control hierarchical level via the gateway node 


OS eS 


is done by entering the node designator of an ESM node. The 


report can then be sent to an ESM terminal or host processor. 
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1.10.6 Mode 6 - Status 


This mode of operation displays the status of simulated equipment 


that is being monitored by MSCDM. 

1.10.7 Program Descriptions 

1.10.7.1 Subroutine USRLNG (FORTRAN ) 

This subroutine is called by the nodal program when a message is 
received from the loop. This module checks for abort commands and 
valid terminal input. The message is then passed to a subroutine 
of the mode the user requested. It also formats all records read 
from the disk into packets to be written to the loop. 


1.10.7.2 Subroutine WRTDB (FORTRAN), 


This subroutine updates recorus (events) in the status sent by the 


FIAC node. 


1.10.7.3 Subroutine M1000 (FORTRAN ) 


This subroutine handles all the CRT-to-CRT messages it receives 


from node 25's LA-36 and reroutes the packet to the designated 


terminal. 


1.10.7.4 Subroutine M2000 (FORTRAN) 


This subroutine handles the system inquiries made by the user. It 


records from the MSG DAT file which contains all the systen 


information and forms it into packets to be sent to the requesting 


terminal. 


1.10.7.5 Subroutine M3000 (FORTRAN) 


This subroutine handles the system update for modules VSQC, DSQC, 


BWBSA, and SDCA. It. decodes commands inputed by the user and 


sends messages to each module concerned. 


1.10.7.6 Subroutine 44000 (FOR'TRAN) 


This subroutine handles the file access mode of the User Language. 


It determines which file (trunk, circuit) is open and which record 


is currently pointed to. 


1.10.7.7 Subroutine M4001 (FORTRAN) 


The subroutine is called by subroutine M4000 and performs the 


editing (addition, deletion, change) of a record in ae file 


(circuit, trunk). 


aie 
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1.10.7.8 Subroutine M5000 (FORTRAN) 


~ 


This subroutine handles the report mode of the User Language. It 


fills in a menu of questions and then writes them out to a select- 


ed terminal. 


1.10.7.9 Subroutine SNDMES (FORTRAN) 


This subroutine is called by subroutine M5000 to send the 


completed report to a terminal in message format. 


1.10.7.10 Subroutine M6000 (FORTRAN) 


This subroutine handles the status mode of the User Lanyguaye. = It 


modifies status of a channel or prints the status out to the 


terminal depending on the response to menu selection. 
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1.10.8 MSG.DAT File 


This is a listing of the file MSG.DAT which the User Language uses 


for the menu formats of all five modes. 
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1.11 SIG, 11/40 Simulating Input Programs 


The Simulated Input Generator (SIG) is a microprocessor that 


generates simulated inputs to the VSQC, DSQC, and BWBSA modules. 


It acts as both a communications sensor and a scanner. It is used 
to simulate the measurements performed on 1000 channels and three 
links, multiplexors, transmitters, and receivers. Random numbers 
are generated for the measurements for the Red, Amber, and Green 
regions. Approximately 10% of the measurements are in the Amber 
region and 5% in the Red region. The SiG continually writes to 
three 9600 baud interfaces to the VSQC, DSQC, and BWBSA nodes. 
Each channel and link is simulated by a measurement report that is 
written to the interface. A VSQC measurement report consists of 
the six parameters given in Section 1.3 plus the channel number, 
trunk, name, and monitor point. A BWBSA meaSurement report con- 
sists of the thirteen parameters given in Section 1.7 plus the 
link number and monitor point. In addition, Multiplexor, Trans- 


mitter, and Receiver Alarms are generated. 


The SIG also responds to commands from the VSQC, DSQC or BWBSA to 
perform a measurement on a specific channel or link. Equipments 
which are in the Red region continue to generate Red measurement 
parameters for a specified number of successive measurements in 


order to simulate hard equipment failures and repair time. 


1.11.1 Program Descriptions 

1.11.1.1 Program SIGGEN (FORTRAN) 

This progran is the simulated input generating program, the 
program loop that continually sends measurements to VSQC, DSQC, 
and BWBSA nodes. The function is described in Section 1.1l. 


1.11.1.2 Subroutine IMAGE (FORTRAN) 


This subroutine takes a decimal number and converts it to ASCII 


with leading zeros placed. 


1.11.1.3 Subroutine DELAY (FORTRAN) 


This subroutine imposes a delay between measurements. 


1.11.1.4 Subroutine INTVEC (MACRO) 


This subroutine initializes the interrupt vectors of the interface 


boards. 


1.11.1.5 Subroutine RDVSQC (MACRO) 


This subroutine reads messages from the VSQC node. 
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1.11.1.6 Subroutine RDDSQC (MACRO) 


This subroutine reads messages from the DSQC node. 


1.11.1.7 Subroutine RDBWSA (MACRO) 


This subroutine reads mesages from the BWBSA node. 
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